home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / gnu / bash / bash_108 / bash-108.zoo / ReadMe.first < prev   
Encoding:
Text File  |  1991-09-12  |  4.1 KB  |  117 lines
  1.  
  2. This file gives some cursory documentation for building and using Bash V1.08
  3. for an Atari ST. 
  4.  
  5. This whole mess is distrubuted as :
  6.  
  7.     1. ReadMe.first          - this file
  8.         2. bash-d2.zoo            - support code and diffs
  9.  
  10. bash-d2.zoo contains :
  11.  
  12.         1. man/bash.1            - the standard bash man page 
  13.        man/Usage            - some cursory documentation on how
  14.                       to use Bash.
  15.        man/bash_login        - a sample .bash_login file
  16.  
  17.     2. st-bash-src/src.diff     - diffs to the FSF Bash Source
  18.            st-bash-src/ReadMe        - a description of st-bash-src dir
  19.            st-bash-src/endian.h        - defines for big endian machine
  20.        st-bash-src/pipesize.h    - defines for sizeof(pipe)
  21.        st-bash-src/sysdefs.h    - Atari system definitions
  22.            st-bash-src/version.h        - defines version 1 of ST-Bash
  23.        st-bash-src/Makefile.cross    - a makefile for building ST-Bash 
  24.                       in a cross development enviroment.
  25.            st-bash-src/ReadMe        - descripion of the directory contents
  26.        st-bash-src/ChangeLog    - what has been done to Bash to 
  27.                       make it work on the ST.
  28.     3. lib+/*            - support routines neeeded on the ST.
  29.  
  30.     4. readline/read.diff        - diffs to the FSF Readline library
  31.        readline/Makefile.cross      - a makefile for building readline.olb
  32.                       in a cross developement enviroment.
  33.        readline/ChangeLog           - what has been done to the readline
  34.                           library to make it work on the ST. 
  35.  
  36.     5. gcclib/ioctl.h        - modified gcc include file
  37.        gcclib/fcntl.h        - ``              ''
  38.        gcclib/close.c        - modified close.c for gnu RTL.
  39.        gcclib/open.c        - modified open.c  for gnu RTL.
  40.        gcclib/pipe.c               - new addition to the gnu RTL.
  41.        gcclib/symdir.c        - modified symdir.c for gnu RTL.
  42.  
  43.  
  44.  
  45. To build this unpack the archive bash-d1.zoo with zoo x.// bash-d1.zoo
  46. in a directory called st-bash-1.08, this will create the above mentioned
  47. directories and files. In this directory create a directory called 
  48. alloc-files/ and leave it empty for the time being.
  49.  
  50.  
  51. ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
  52. !!!!!!!!********README NOW********||||||||||||||||||||||||||||||||||||||||||
  53. ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
  54. [ As  of PathLevel 72 of the gnu rtl from Jawhar Bammi, the routines 
  55.   in gnulib/* are not yet incorporated into the GCC Run-Time-Library.
  56.   What you need to do is copy libgcc/*.h into your gcc-include directory,
  57.   copy gcclib/*.c into your lib-source/  directory (source for the RTL)
  58.   add pipe.o to the list of unix files in "mincl", then build a new 
  59.   gnu.olb library.
  60. ]
  61.  
  62.  
  63.  
  64. You need to get the original distribution of (Bashv1.08 + Patches) from 
  65. prep.ai.mit.edu and unpack it somewhere. Apply the patches that you got
  66. from prep.
  67.  
  68. ----------------
  69. (A) copy :
  70.         alias.c         alias.h        bashline.c    braces.c    
  71.     builtins.c    builtins.h    config.h    copy_cmd.c
  72.     dispose_cmd.c    endian.h    execute_cmd.c    expr.c
  73.     fc.c        flags.c        flags.h        general.c
  74.     general.h    glob.c        hash.c        hash.h
  75.     jobs.c        jobs.h        longest_sig.c    machines.h
  76.     mailcheck.c    make_cmd.c    ndir.h        nojobs.c
  77.     parse.y        posixstat.h    print_cmd.c    quit.h
  78.     shell.c        shell.h        siglist.c    subst.c
  79.     sysdefs.h    test.c        trap.c        trap.h
  80.     ulimit.c    unwind_prot.c    variables.c    variables.h
  81.     version.c    version.h
  82. from the patched FSF distribution into : st-bash-108/st-bash-src/
  83.  
  84. cd st-bash-108/st-bash-src 
  85. apply the diffs src.diff
  86. ----------------
  87.  
  88. (B) copy :
  89.     readline/* 
  90. from the patched FSF distribution into : st-bash-108/readline/
  91.  
  92. cd st-bash-108/readline
  93. apply the diffs read.diff
  94. ----------------
  95.  
  96. (C) copy :
  97.     alloc-files/*
  98. from the patched FSF distribution into : st-bash-108/alloc-files/
  99. ----------------
  100.  
  101. !!! Now all the files are in place and patched for the Atari ST. !!!
  102.  
  103. All that is left is the compilation.
  104.  
  105.     (i)    cd st-bash-108/readline
  106.         hit make
  107.         copy readline.olb to your library directory.
  108.  
  109.     (ii)    cd st-bash-108/st-bash-src
  110.         hit make
  111.         This should give a bash.ttp file all ready to be fired up!
  112.                 If at this stage you get a message from the linker saying 
  113.         flush_key_buff() or _del_symdir_cache() not found, you 
  114.         need a new termcap.olb or gnu.olb!
  115.  
  116.  
  117. -----------------------------------------------------------------------------